Obtener categoría

curl --request GET \
  --url https://api.example.com/menus/categories/{id}

{
  "data": {
    "id": "hamburguesas",
    "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Hamburguesas",
    "description": "Hamburguesas artesanales",
    "channels": {
      "APP": {
        "id": "app",
        "uid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "name": "App móvil",
        "stores": {
          "centro": {
            "id": "centro",
            "uid": "c3d4e5f6-a7b8-9012-cdef-123456789012",
            "name": "Centro",
            "fulfillment": {
              "DELIVERY": {
                "uid": "d4e5f6a7-b8c9-0123-def4-567890abcdef",
                "id": "delivery",
                "type": "DELIVERY",
                "name": "Delivery",
                "availability": {
                  "status": "ACTIVE",
                  "schedules": [{
                    "monday": { "start_time": "11:00:00", "end_time": "22:00:00" }
                  }],
                  "inactive_until": null
                }
              }
            }
          }
        }
      }
    },
    "cms_template_id": null,
    "cms": null,
    "status": "ACTIVE"
  }
}

GET

menus

categories

{id}

Obtener categoría

curl --request GET \
  --url https://api.example.com/menus/categories/{id}

{
  "data": {
    "id": "hamburguesas",
    "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Hamburguesas",
    "description": "Hamburguesas artesanales",
    "channels": {
      "APP": {
        "id": "app",
        "uid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "name": "App móvil",
        "stores": {
          "centro": {
            "id": "centro",
            "uid": "c3d4e5f6-a7b8-9012-cdef-123456789012",
            "name": "Centro",
            "fulfillment": {
              "DELIVERY": {
                "uid": "d4e5f6a7-b8c9-0123-def4-567890abcdef",
                "id": "delivery",
                "type": "DELIVERY",
                "name": "Delivery",
                "availability": {
                  "status": "ACTIVE",
                  "schedules": [{
                    "monday": { "start_time": "11:00:00", "end_time": "22:00:00" }
                  }],
                  "inactive_until": null
                }
              }
            }
          }
        }
      }
    },
    "cms_template_id": null,
    "cms": null,
    "status": "ACTIVE"
  }
}

Devuelve una categoría del menú activo, incluyendo cómo aparece en distintos canales, tiendas y tipos de fulfillment. Usa este endpoint para renderizar encabezados, descripciones e indicadores de disponibilidad en tu UI de pedidos.

Requiere un access token de Fire spark obtenido mediante intercambio de token.

Parámetros de ruta

Parámetro	Descripción
`id`	Identificador externo de la categoría. Solo alfanuméricos, `_` y `-`. 1–64 caracteres.

Parámetros de consulta

Parámetro	Requerido	Descripción
`store_id`	Sí	Identificador externo de la tienda.
`channel_id`	Sí	Identificador externo del canal.
`fulfillment_id`	Sí	Identificador externo de fulfillment.

Request

curl "https://firespark.vercel.app/api/storefront/v1/menus/categories/hamburguesas?store_id=centro&channel_id=app&fulfillment_id=delivery" \
  -H "Authorization: Bearer ACCESS_TOKEN"

Response

{
  "data": {
    "id": "hamburguesas",
    "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Hamburguesas",
    "description": "Hamburguesas artesanales",
    "channels": {
      "APP": {
        "id": "app",
        "uid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "name": "App móvil",
        "stores": {
          "centro": {
            "id": "centro",
            "uid": "c3d4e5f6-a7b8-9012-cdef-123456789012",
            "name": "Centro",
            "fulfillment": {
              "DELIVERY": {
                "uid": "d4e5f6a7-b8c9-0123-def4-567890abcdef",
                "id": "delivery",
                "type": "DELIVERY",
                "name": "Delivery",
                "availability": {
                  "status": "ACTIVE",
                  "schedules": [{
                    "monday": { "start_time": "11:00:00", "end_time": "22:00:00" }
                  }],
                  "inactive_until": null
                }
              }
            }
          }
        }
      }
    },
    "cms_template_id": null,
    "cms": null,
    "status": "ACTIVE"
  }
}

Objeto categoría

Campo	Tipo	Descripción
`id`	string	Identificador externo de la categoría.
`uid`	string (UUID)	Identificador interno de Fire spark.
`name`	string	Nombre visible. 1–100 caracteres.
`description`	string	Descripción opcional. Hasta 500 caracteres. `null` si se omite.
`channels`	object	Visibilidad y disponibilidad por canal, indexada por código de canal.
`cms_template_id`	string (UUID)	Plantilla CMS vinculada. `null` si no hay plantilla asignada.
`cms`	object	Solo lectura. Plantilla CMS resuelta cuando está asignada.
`status`	string	`ACTIVE` o `INACTIVE`.

channels

Mapa de códigos de canal. Cada entrada contiene id, uid, name y un mapa stores.Cada tienda contiene id, uid, name y un mapa fulfillment indexado por código de tipo de fulfillment.Cada entrada de fulfillment requiere uid, id, type, name y availability.

availability

Campo	Tipo	Descripción
`status`	string	`ACTIVE`, `INACTIVE` o `HIDDEN`.
`schedules`	array \| null	Mapas de horario semanal indexados por día (`monday` a `sunday`). `null` cuando no hay restricción de horarios.
`inactive_until`	string	Fecha y hora ISO 8601 opcional cuando termina un estado inactivo temporal.

Respuestas de error

Estado	Descripción
`401`	Access token ausente o inválido.
`403`	El token no tiene acceso a esta categoría.
`404`	Categoría no encontrada en el menú activo para este contexto.

Listar menús Obtener producto

⌘I

​Parámetros de ruta

​Parámetros de consulta

​Request

​Response

​Objeto categoría

​Respuestas de error

Parámetros de ruta

Parámetros de consulta

Request

Response

Objeto categoría

Respuestas de error